Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Media Functions / Selecting Media Handlers

GetMediaDataHandler

The GetMediaDataHandler function allows you to determine a media's data handler.

pascal DataHandler GetMediaDataHandler (Media theMedia, 
                                       short index); 

theMedia

Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as NewTrackMedia and GetTrackMedia (described on page 2-138 and page 2-190, respectively).

index

Identifies the data reference. You provide the index value that corresponds to the data reference for which you want to retrieve the data handler. You must set this parameter to 1.

DESCRIPTION

The GetMediaDataHandler function returns a data handler identifier. This identifier is a component instance that specifies a connection to a data handler component (see the chapter "Component Manager" in Inside Macintosh: More Macintosh Toolbox for more information about components). If the Movie Toolbox cannot determine the data handler for the media you specify, the function sets this returned value to nil.

Note

Your application should not need to call this function.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid